home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 4 / United Public Domain Gold 4.iso / tbag / tb015.dms / tb015.adf / Doc-Files / Utilities.Doc < prev    next >
Text File  |  1988-01-02  |  31KB  |  716 lines
  1.  
  3. Utilities.Docs
  5. This file includes Documentation for all files in the Utilities Drawer. They 
  6. have all been combined into one to save disk space.
  7.  
  8. The Docs included in this file are:
  10. Mach.Doc
  11. EA-Fix.Doc
  12. VirusChecker.Doc
  13. WB-Depth.Doc
  14. ScrinkWrap.Doc
  15. DropCloth.Doc
  17.  
  18. Doc File Headers are in RED!
  19.  
  20. *****************************************************************************
  22. Mach -  Mouse Accelerator with Hotkey.           Version 1.4  12-23-87.
  23. MachClk - Mach + Title Bar Clock and Beeper.     Version 1.0  12-23-87.
  25.  
  26.  
  27.     NOTES: 1. Mach is identical to MachClk minus the clock. Features that
  28.               apply only to MachClk are so noted.
  29.  
  30.            2. References in this document to "Qualifier" means either the
  31.               left or right Alternate or Amiga keys depending on whether
  32.               or not you use "-a" on the command line.
  33.  
  34.            3. When used on the command line, function keys are single digits.
  35.               1 is F1, 2 is F2, 9 is F9, and 0 is F10.
  36.  
  37.     USAGE:
  38.  
  39.        Run Mach [nscmdaeb] hotkeystring hotkeystring...hotkeystring
  40.                             or
  41.        Run Mach [nscmdaeb] +1hotkeystring +2hotkeystring...+nhotkeystring
  42.  
  43.                             or
  44.  
  45.        Run MachClk [nscmdaebkt] hotkeystring hotkeystring...hotkeystring
  46.                             or
  47.        Run MachClk [nscmdaebkt] +1hotkeystring +2hotkeystring...+nhotkeystring
  48.  
  49.  
  50.      Arguments: All optional. Any order.
  51.  
  52.      -n    Acceleration factor where n >= 0 && n <=9.
  53.      -s    Removes sunmouse.
  54.      -c    Removes click to front.
  55.      -m    Removes the trapping of left-amiga-m. (allows normal use)
  56.      -d    Adds double control feature.
  57.      -a    Use the Amiga keys as qualifiers.
  58.      -estr Use str as execute string. Default is "NewCLI >nil: <nil:".
  59.      -bnn  Time delay before blanking screen. 0-99 minutes. 0 = no blank.
  60.      -knnn Put Clock left edge at nnn. (MachClk only)
  61.      -tnn  Beep every nn minutes. Default 15. (MachClk only)
  62.  
  63.  
  64.     Hotkeys:
  65.  
  66.        The hotkeys are the keys F1 to F10 qualified with the left or
  67.        right alternate keys. If you prefer to use left or right Amiga, put
  68.        -a on the command line. This makes it more compatible with WordPerfect
  69.        and other programs that make use of alternate-function keys.
  70.        The escape character "\" may be used to introduce newline or a function
  71.        key or to add qualifiers.
  72.          \n  newline
  73.          \c  control
  74.          \a  alternate
  75.          \A  Amiga
  76.          \s  shift
  77.          \f  function key where f is 1-0 = F1-F10
  78.  
  79.          c, a, A, s modifiy the next letter. They can be combined.
  80.          c, s, and n may be upper case.
  81.          Examples:
  82.               \C\a\3  sends Control-Alternate-F3.
  83.               \A\0    sends Amiga-F10.
  84.  
  85.          Hotkeys may call other hotkeys.
  86.  
  87.        The hotkeys are defined in the command line following the optional
  88.        options. Definitions with embedded spaces should use "".
  89.        They may be positional, that is, the first definition is matched
  90.        with F1 and the second with F2. Or, you may specify a function key
  91.        with +n. n = 1 - 0. 0 is F10. No spaces may follow the key number.
  92.        e.g. Run Mach "+5diskcopy df0: to df1:\n"
  93.        See more examples below.
  94.        You may redefine hotkeys by running Mach again with new definitions.
  95.        e.g. Mach +3dir\n "+0run df1:wp\n"
  96.  
  97.     Accelerator:
  98.  
  99.        The accelerator speeds up mouse movements. It accepts as an argument
  100.        a number, 0-9, which sets its speed.
  101.        -1 is the default, -0 = no acceleration. (I use -4).
  102.  
  103.     NewCLI:
  104.  
  105.        The qualifier and ESCape combination will create a NewCLI.
  106.        You need to have NewCLI and Run in the c: directory. You can change
  107.        this from NewCLI to another command with -estring. A full window
  108.        can be used with "-eNewCLI CON:0/0/640/200/MyCLI".
  109.        The NewCLI will have the same size stack as Mach.
  110.  
  111.     Screen Blanker:
  112.  
  113.        After 5 minutes of no mouse or keyboard activity, the screen will
  114.        go blank. You can change this default with -bnn where nn = 0 - 99
  115.        minutes. 0 disables blanking.
  116.        Instant blanking: Control-Qualifier-F2.
  117.  
  118.     Sun Mouse:
  119.  
  120.        The window that the pointer is over becomes the active window
  121.        after the first mouse movement. To be able to drag icons, the
  122.        sun mouse is disabled while the left button is held down.
  123.        If you don't want the sun mouse, use -s on the command line.
  124.        On/off toggle: Control-Qualifier-F3.
  125.  
  126.     Click To Front:
  127.  
  128.        You can click in any part of a window and bring it to the front.
  129.        If you don't want this, use -c on the command line.
  130.        On/off toggle: Control-Qualifier-F4.
  131.  
  132.     Screen Shuffler:
  133.  
  134.        Left-Amiga-M will push the front screen to the back instead of
  135.        pushing workbench screen to the back.
  136.        Left-Amiga-N will still bring the workbench to the front.
  137.        This is useful if you have more than two screens on at once,
  138.        especially if they don't have screen depth gadgets.
  139.        If you don't want this feature, use -m on your command line.
  140.        On/off toggle: Control-Qualifier-F5.
  141.  
  142.     Clock:
  143.  
  144.        MachClk has a title bar clock that displays available memory and the
  145.        time. You can change its left edge position with -knnn. For no clock
  146.        use -k0 or -k. The clock is updated every second and brings itself
  147.        to the front (if covered up) every 4 seconds except when the left
  148.        button is held down. The current toggles are shown in the left corner.
  149.        They are s: sun mouse, c: click to front, m: Amiga-M screen shuffler,
  150.        d: double control, a: Alternate/Amiga qualifiers.
  151.        On/off toggle: Control-Qualifier-F8.
  152.  
  153.     Beeper:
  154.  
  155.        MachClk (when the clock is activated) has a beeper (to keep you awake)
  156.        which defaults to a 15 minute interval. Change this with -tnn.
  157.        nn = 0 to 60 minutes.
  158.  
  159.     Uninstall:
  160.  
  161.        Use the combination Control-Qualifier-F1 to uninstall Mach or MachClk.
  162.  
  163.     Toggles:
  164.  
  165.        These key combinations can be used to toggle specific features.
  166.  
  167.         Ctl-Qualifier-
  168.           F3  Sun mouse.
  169.           F4  Click to front.
  170.           F5  Screen shuffle.
  171.           F6  Double control.
  172.           F7  Alternate/Amiga qualifiers.
  173.           F8  Clock. (MachClk only)
  174.  
  175.         F3-F7 are displayed in the clock as [scmda].
  176.  
  177.     Instant blanker:
  178.  
  179.           Ctl-Qualifier-F2  Causes the screen to go blank immediately.
  180.  
  181.  
  182.  
  183.     EXAMPLES:
  184.  
  185.        Run Mach -2 -m -s df0: df1: "dir\n" "copy " "" "run sys:system/rollodex"
  186.          This maps
  187.              Alternate-F1 to  df0:
  188.              Alternate-F2 to  df1:
  189.              Alternate-F3 to  dir + return
  190.              Alternate-F4 to  copy
  191.              Alternate-F5 to  nothing
  192.              Alternate-F6 to  run sys:system/rollodex
  193.  
  194.          The options set the acceleration factor to 2, allows the normal use
  195.          of Left-Amiga-M, and disables the sun mouse feature.
  196.  
  197.  
  198.        Run MachClk -a -0 -c -b12 "run df1:wp\n" +5df0: \s\c\1 \c\A\0 dir\n\A\1
  199.          This maps
  200.            Amiga-F1 to  run df1:wp + return
  201.            Amiga-F5 to  df0:
  202.            Amiga-F6 to  Shift-Control-F1
  203.            Amiga-F7 to  Control-Amiga-F10
  204.            Amiga-F8 to  dir + return + Amiga-F1
  205.  
  206.          The options set the acceleration factor to 0, the function key
  207.          qualifiers to the Amiga keys, disables the click to front feature,
  208.          and sets the waiting before blanking to 12 minutes.
  209.          The clock is placed in its default position and the beeper interval
  210.          is the default 15 minutes.
  211.  
  212.  
  213.        Run MachClk -k200 -t30 -4 -a "diskcopy df0: to df1:\n"
  214.          This maps
  215.            Amiga-F1 to  diskcopy df0: to df1: + return
  216.  
  217.          The options use 200 for the clock's left edge, sets the beeper
  218.          interval to 30 minutes, the acceleration factor to 4, and the
  219.          qualifiers to the Amiga keys.
  220.  
  221.  
  222.  
  223.     REDEFINING:
  224.  
  225.        Mach may be run again to redefine hotkeys or set the blanking
  226.        time delay or the beep interval or to change the toggles.
  227.        For example, after Mach is running, typing "Mach -6 +5df0:"
  228.        will change the acceleration factor to 6 and redefine F5 to "df0:".
  229.        Only the clock position may not be changed this way.
  230.  
  231.        Mach -b10 +3CCC +2BBB +5EEE FFF
  232.          This redefines
  233.            Qualifier-F2 to  BBB
  234.            Qualifier-F3 to  CCC
  235.            Qualifier-F5 to  EEE
  236.            Qualifier-F6 to  FFF
  237.  
  238.          and resets the blanking delay to 10 minutes.
  239.  
  240.  
  241.        Mach -eWack
  242.          This changes the Qualifier-ESCape command from NewCLI to Wack.
  243.          Remember, the executed command will have the same size stack
  244.          as Mach.
  245.  
  246.  
  247.     MISCELLANEOUS:
  248.  
  249.        Note that anything after a semicolon is treated as a comment.
  250.        If you are typing this in from the CLI, when you reach the end of
  251.        the line, don't hit return and you can continue mapping up to 255
  252.        characters (including run mach [options]). If you are using an editor
  253.        or word processor, use one that can handle long lines. You can use
  254.        Ed but you need to use the command SR or EX. You can then put this
  255.        in your startup-sequence.
  256.  
  257.        I have found that the hotkeys do not function properly with the
  258.        program Sili(Con:).
  259.        Let me know if you find other incompatibilities.
  260.  
  261.        If you do "stack 2000" before you run Mach, it will use about
  262.        16k. Be sure to reset your stack to 4000 or higher after this.
  263.        MachClk uses about 4k more than Mach.
  264.        If for any reason Mach fails to run (e.g. no free signals, no
  265.        input.device??) it will use a return code of 10 or higher.
  266.  
  267.        The NewCLI brought up by Qualifier-ESC will have a stack the same
  268.        size as Mach. Many programs that you may run from this CLI need a
  269.        larger stack so either run Mach with a larger stack or, after you
  270.        get a NewCLI, use the stack command to set your stack to a larger
  271.        value. If programs mysteriously crash when run from the NewCLI, it
  272.        may be caused by the stack size.
  273.  
  274.     Hidden Control Feature:
  275.  
  276.        If you happen to be a one handed typist, you know what a pain
  277.        it is when you need to do a Control-F10 or any combination of
  278.        the Control key and a key on the right side of the keyboard.
  279.        If you put -d on the command line, you can still use the Control
  280.        key in the normal way but if you hit it twice in a row, the NEXT
  281.        key will have the Control qualifier added to it. This excludes
  282.        the shift, alternate or amiga keys so, for example, ctl-ctl-f10
  283.        is the same as ctl-f10 but you don't need to hold down the control
  284.        key. Ctl-ctl-shift-p is the same as ctl-shift-p.
  285.        Note that this is normally disabled unlike all the other features.
  286.        On/off toggle: Control-Qualifier-F6.
  287.  
  288.  
  289.  
  290.        Copyright 1987 by Brian Moats
  291.                          Polyglot Software
  292.                          10431 Ardyce Court
  293.                          Boise, Idaho 83704
  294.  
  295.                          PeopleLink - BrianM
  296.                          CI$        - 76167,2334
  297.  
  298.        This program may be freely distributed but may not be used in any
  299.        commercial product without prior written permission.
  300.        Source available. Donations accepted.
  301.  
  302.  
  303.  
  304.  
  305.   Other programs from Polyglot Software:
  306.  
  307.   M18Cheater - Lets you cheat in Mean 18 by causing your opponent to
  308.                slice. Public domain.
  309.  
  310.   FunBut - Lets you use the F1 key instead of the left mouse button.
  311.            It's useful when playing games like Defender of the Crown
  312.            because it sends repeat mouse clicks.  Public Domain.
  313.  
  314.   Dominoes - 3d graphics, instructions, tutorial. More entertaining and
  315.              challenging than Shanghai.  $24.95
  316.  
  317.   The Crossword Creator - Make or solve crossword puzzles. 40,000+ word
  318.                           pattern matching dictionary, med-res or interlace,
  319.                           IFF compatible and many more features. $49.95
  320.  
  321. *****************************************************************************
  322.  
  323. EA-FIX
  324. FixBoot 0.0, Copyrighe © 1987 by Jerry Masker, Getzville, N. Y.
  326. This program may be copied and used freely as long as the original copyright
  327. notice in the program is left intact.  The author makes no warranties of any
  328. kind about this program - USE AT YOUR OWN RISK!
  329.  
  330. Certain early programs for the Amiga were not designed with expanded memory
  331. in mind.  Some of them auto-boot as a workbench disk, thereby precluding the
  332. use of the NoFastMem program supplied with the Amiga 2000.  This program has
  333. been implemented to solve that problem.  Some of the programs this program
  334. effectively fixes include Arcticfox and Skyfox.  It will also work with
  335. Deluxe Print, although the NoFastMem program could be placed on the disk
  336. and executed manually.
  337.  
  338. This program reads in the bootblock of the requested disk.  It then copies
  339. the existing program boot code down in the bootblock and inserts a small
  340. segment of code which, upon booting the disk, eats all the available
  341. expansion memory.  A new blotblock checksum is calculated and stored in the
  342. bootblock, and the bootblock is written back to disk.
  343.  
  344. To use this program, setup using the following CLI commands:
  345.  
  346.    copy FixBoot ram:
  347.    cd ram:
  348.  
  349. Then, REMOVE ALL DISKS FROM THE SYSTEM in case you make a mistake.  Insert
  350. the disk to be repaired, with write enabled, in any of the drives and type:
  351.  
  352.    FixBoot <drive number>
  353.  
  354. Notes:
  355.  
  356.    1. Use a COPY of the disk to be fixed in case something goes wrong! You
  357.       may have to use one of the copy programs such as Marauder if the
  358.       original is copy protected.
  359.  
  360.    2. Error reporting by this program is almost nonexistent.  For example,
  361.       if you forget to write enable the disk, the program probably will not
  362.       report it.
  363.  
  364.    3. The program assumes that there is space available in the bootblock for
  365.       the "memory gobbler" to be inserted.  I have not seen any programs
  366.       where the bootblock contained so much code that this segment could
  367.       not be inserted.  HOWEVER - if you execute this program several times,
  368.       on the same disk, you will be inserting multiple copies of the "memory
  369.       gobbler", and will eventually overflow the bootblock.  Extra "memory
  370.       gobbler" segments typically won't hurt anything unless this condition
  371.       arises; but the old saying "if a little's good, a lot must be better"
  372.       certainly doesn't apply here!
  373.  
  374.    4. The VIP PROFESSIONAL spreadsheet program disk does not have a problem
  375.       with extra memory; you must use it in drive df0: on the A2000.  Its
  376.       problem is that there isn't a drive df1: on some machines, and the
  377.       code searching for drives leaves a lot to be desired.  Anyway,
  378.       FixBoot won't help - it only hurts by reducing the size of the
  379.       spreadsheets the program can handle.  (Also, with VIP, don't forget
  380.       to change stack to 40000 if you have extra memory installed.)
  381.  
  382.    5. See also my program HackerFix to repair Hacker I disks.  FixBoot
  383.       is not needed for Hacker I.
  384.  
  385. *****************************************************************************
  387. Virus-Checker.Doc
  389. This program can check for the presence of either of the two currently
  390. known Amiga viruses.  It can check for the presence in memory and
  391. optionally on a specified disk drive.
  392.  
  393.   If found in memory, it will clear out the offending virus.  If the virus
  394. is discovered on a disk, you may use the DOS command INSTALL write a new
  395. boot track and clear the disk of the virus.
  396.  
  397.    CAUTION -- using the INSTALL command on some commercial (game) disks
  398. may destroy the copy protection and render the disk unusable.
  399.  
  400. *****************************************************************************
  402. WBDepth (c) Copyright 1987 by Andry Rachmat
  404.  
  405.     Have you read the info on how to modify KickStart disk so that
  406. you can have 8 colors on the Workbench? Interesting, isn't it?
  407.  
  408.     The unfortunate things are you, 500 & 2000 & kickstart on the rom
  409. owners, are left in the cold, and it is a hassle if you want to change
  410. the depth back and forward (i.e. you need to reboot with different
  411. kickstart disk everytime).
  412.  
  413.     Well, here comes 'WBDepth' to the rescue....
  414. What WBDepth does is simply changes the number of planes of the WB screen
  415. on the fly. No need to reboot, no need to bother with kickstart disk.
  416.  
  417. Usage:
  418.     WBDepth [number]
  419. Example:
  420.     WBDepth        -> will show the current WB screen parameters
  421.     WBDepth ?    -> will show the usage
  422.     WBDepth 1    -> change to 1 planes (2 colors)
  423.     WBDepth 2    -> change to 2 planes (4 colors), standard
  424.     WBDepth    3    -> change to 3 planes (8 colors)
  425.     WBDepth 4    -> don't try it, unless you are ready to reboot
  426.  
  427.     This is CLI only program, [number] is a single digit number 1-5.
  428. However, don't use number greater than 3. The ability to use the number
  429. greater than 3 is just there to show that the system will screw up,
  430. and will hang, and perhaps will guru (CATS: what is wrong here ?).
  431. If you want speed use 1, and if you want fanciness use 3 (8 colors).
  432.  
  433.     To see the speed variation, here some timing for 'Type'ing a
  434. 4000 bytes text file on CLI (Blitzfonts installed).
  435.     3 planes: 15   seconds
  436.     2 planes:  9   seconds
  437.     1 plane :  5.5 seconds
  438. (note: no wonder if 'Blitz' can go that fast, being written is assembly
  439. plus only using 1 plane for sure will help the speedup).
  440.  
  441.     8 colors will be suitable for self-bootable graphics demo disk.
  442. In that case you might need to grab 'SetColor' on the 'WBench8.arc'
  443. (this arc file contains the infomation on how to modify the kickstart
  444. disk to get 8 colors, and some utility programs). Setcolor will allow
  445. you the change the extra 4 colors (color 4-7) automatically. For
  446. manual changes you can use 'PopColor' or 'ColorDemo'.
  447.  
  448.     All programs mention here are PD or Shareware, and so does this
  449. program. It is a Public Domain, dedicated to ALL PD and SHAREWARE authors.
  450. Thanks for writing GREAT programs for this GREAT machine that we all LOVE.
  451.     Also thanks to Sysops across the nation for keeping PD programs
  452. distributed. I know it is a dirty job, but somebody got to do it.
  453.  
  454.     Finally to you all, AMIGA users, Merry Christmas!!!
  455.  
  456. - Give a big favor will you, spread this program around. Danke!
  457. Plink: A*Rachmat
  458. Other BBSes: I might be there.
  459.  
  460. *****************************************************************************
  462. ScrinkWrap1.0  
  463.   
  464.     This program has been released into the public domain. It may not be 
  465.  sold or distributed in whole or in part for profit in any way without   
  466.  an express written consent from Tony Solomon.  This program and all re-
  467.  lating files may be freely distributed by any means providing this program
  468.  has not been altered in any way.                                            
  469.                                                                          
  470.                                                                          
  471.  Disclaimer:  This program is presented on an 'as is' basis.  I make no 
  472.  guarantees for it's suitability for any purpose whatsoever.  I cannot  
  473.  be held responsible for any damages resulting from it's  use, reuse,
  474.  misuse, or abuse (Whew).   ScrinkWrap © copyright 1987...Tony Solomon.  
  475.                                                                          
  476.  
  477. What is ScrinkWrap?  ScrinkWrap is a program which allows you to resize any
  478. WINDOW (not screen) regardless of its status, size etc.  As long as you know
  479. the windows name, it may be resized!
  480.  
  481. After receiving FACCI (great program Perry! FACCIIs even better) I did'nt
  482. like having the window around (read noticible) all the time.  So I thought
  483. it would be nice to just resize it so small it would be less noticable.  Well
  484. I was just learning "C" at the time and was very busy so the project was
  485. canned (anyway AUTOFACC did a nice job ;-) ).  Recently I had a similar pro-
  486. blem come up where I wanted to get rid of a window with no sizing gadget, hence
  487. ScrinkWrap.  Originally ScrinkWrap just scrunk AmigaDOSs window down to 1X1
  488. just like a similar program called Tiny.  I thought it would be fun to resize
  489. any window (not a very nice thing to do but fun anyway), so ScrinkWrap grew
  490. to where it is today.
  491.  
  492. Great so how do I use it.  I'm glad you asked.  ScrinkWrap is pretty easy to
  493. use, the following is a brief rundown of its syntax:
  494.  
  495. ScrinkWrap                          - Will look for the window named 'AmigaDOS'
  496.                                       and scrink it to 1X1.  Great for Work-
  497.                                       bench users who want a CLI around!  To 
  498.                                       use it just click in the upper left-hand
  499.                                       corner of the screen, and then type your
  500.                                       command.  You may also go to the upper
  501.                                       left corner and drag the window open 
  502.                                       again!
  503.  
  504. ScrinkWrap <anyletter>              - This will run thorough the list of active
  505.                                       windows and write them to the screen, 
  506.                                       providing the letter you use is not a 
  507.                                       current window title.
  508.  
  509. ScrinkWrap New                      - Will look for the window titled 'New'
  510.                                       (note upper/lower case) and scrink it
  511.                                       to 1X1 pixels.
  512.  
  513. ScrinkWrap New 640 100              - Will look for the window titled 'New'
  514.                                       and will attempt to resize it to 640X100,
  515.                                       at pixel position 0,0.
  516.  
  517. ScrinkWrap New a                    - Will autosize the window titled 'New'
  518.                                       (CLI only!) to a size easy to locate.
  519.                                       This is usefull if you have scrunk a
  520.                                       window and can't find it.
  521.  
  522. ScrinkWrap New A                    - Will autosize the window titled 'New'
  523.                                       (use on Workbench windows!! not 'a')
  524.                                       to a size easy to locate.
  525.  
  526. ScrinkWrap "New CLI"                - Will resize a window titled 'New CLI'
  527.                                       (note the quotes for the space in the
  528.                                       filename) to 1X1 pixels.
  529.  
  530. ScrinkWrap ""                       - Will attempt to resize a titleless
  531.                                       window to 1X1 pixels.
  532.  
  533. ScrinkWrap ?                        - Displays a help screen.
  534.  
  535.  
  536. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  537. 26-Dec-1987
  538.  
  539. PLEASE READ!!
  540.  
  541. Known problems/side-effects.  Since some windows were not designed to be 1X1
  542. pixels.  DOS sometimes has problems redrawing the title bar and left border.
  543. If this occurs, just resize the window and hopefully DOS will redraw.  
  544. Normally the upper 1/4 of the left-border will disappear.  This will not 
  545. affect the operation of the window it is just a little annoying.  ScrinkWrap
  546. does NOT mess with MinWidth/Height of windows, so if a window has been scrunk
  547. and you attempt to resize it, it will only scrink back to its minimum dimen-
  548. tions.  If you forget and use the 'a' autosize function on a Workbench window,
  549. you will get a Guru (use the 'A' function for Workbench windows).  ScrinkWrap
  550. does not work correctly under Shell 207, make sure (if you are a Shell user)
  551. to start a New CLI before using ScrinkWrap.  Or if it is in your startup-
  552. sequence, make sure it is before your call to Shell.  ScrinkWrap was designed
  553. for experimentation.  Please have fun with it, it was a two day hack so it 
  554. probably has a few bugs.  I use an A1000 w/2 drives and a 2 meg StarboardII.
  555. I have not tried it on any other system but my own so I would appreciate 
  556. hearing your bug reports/comments etc!
  557.  
  558. Please send any feedback/comments to:
  559.                          Tony Solomon     PLINK ID - Tony*S
  560.  
  561.  
  562.  
  563.  
  564. Thanks to M. Stolnicki for the examples.
  565.  
  566. **************************************************************************
  568.                              DropCloth
  569.                             Version 2.2
  570.                           By Eric Lavitsky
  571.                           10-November-1987
  572.                      (C) 1987 by Eric Lavitsky
  573.  
  575. DropCloth lets you place a pattern, a 2 bitplane IFF image or a
  576. combination of a pattern and image into your Amiga's WorkBench
  577. backdrop.
  578.  
  579. To use DropCloth from the CLI, type:
  580.  
  581.         1>dropcloth [-d number] [-i filename]
  582.  
  583. where "number" is between 0 and 64 inclusive and "filename" is a
  584. valid 2 bitplane (4 color) IFF image file. The number specifies
  585. the intensity of the pattern used for the backdrop, 0 will render
  586. a clear pattern    into the display, while    64 will render a solid
  587. backdrop. If you don't specify a pattern, DropCloth will default
  588. to 0, a clear pattern. To remove DropCloth and any pattern or image
  589. it has rendered into the backdrop, simply run DropCloth a second
  590. time. It is generally recommended that DropCloth be "RUN" or
  591. "RUNBACKED" from the CLI.
  592.  
  593. To use DropCloth from the WorkBench:
  594.  
  595.         Double click directly on the DropCloth Icon or
  596.         Double click on an IFF image Icon whose default
  597.         tool points to DropCloth.
  598.  
  599. The image must be an IFF image (ILBM). Change it's default tool to
  600. point to DropCloth. Assuming DropCloth resides in the C: directory,
  601. select the image icon and then select "Info" from the WorkBench menu.
  602. The next to last field in the Icon is the default tool:
  603.                   ____________________________
  604.         DEFAULT TOOL  | C:DropCloth              |
  605.                   ----------------------------
  606.  
  607. If your image does not have an Icon, you may create an Icon for it by
  608. copying one of the Icons normally created by DPaint. If you want 
  609. DropCloth to render a pattern, specify the pattern you want in the
  610. ToolTypes of the DropCloth Icon (if you are rendering a pattern only)
  611. or in the ToolTypes of the image Icon (if you are rendering an image
  612. along with a pattern). Again, select the Icon in question, pull down
  613. "Info" from the WorkBench menu, go down to the ToolTypes field, select
  614. "ADD", click in the ToolTypes text gadget and enter:
  615.         _________________________________
  616.         |PATTERN=n            |
  617.         ---------------------------------
  618.  
  619. where n is again a number between 0 and 64 inclusive.
  620. To remove dropcloth and any pattern or image it has rendered into the
  621. WorkBench backdrop, simply run DropCloth a second time by double
  622. clicking on it's Icon.
  623.  
  624. - Features and Limitations
  625.     - Current version wants 640x200x2 images - patterns work fine in any
  626.     size screen including "morerowed" (overscan) screens.
  627.     - We make a few assumptions about the IFF image that limit us to
  628.     accepting only 2 bitplane images.
  629.     - The fuel gauge in main disk windows is not properly refreshed by
  630.     RefreshWindowFrame() ... (sigh)
  631.     - Requires V1.2 or greater of KickStart to run
  632.  
  633. - Future considerations
  634.     - We could give an option to add bitplanes to the workbench screen for
  635.     images > 2 bitplanes or try and map colors to 2 bitplanes. This would
  636.     slow things down and eat lots of CHIP memory (ugh!).
  637.  
  638. HISTORY
  639.  
  640. - How it started
  641.     - When I first got my Amiga way back in August '85, I was
  642. dissapointed to find that I couldn't put an image or pattern in my
  643. backdrop like we could on the AI workstations and Macintoshes at Rutgers.
  644.     - One day, someone posted on the net that at a gathering in the
  645. Apple Computer cafeteria one day, Andy Hertzfeld, of Macintosh design
  646. team fame, was quoted as saying that the Amiga wasn't a serious machine:
  647. "C'mon,    a user interface with windows the same color as the screen?!!!".
  648. I vowed that one day, I'd show him! :-)
  649.     - One day, in one of our usual hacking sessions, Perry Kivolowitz
  650. and I started fooling with the layers library to see what we could make it
  651. do.  It was here we discovered that the WorkBench backdrop was a backdrop
  652. borderless window and that we could look at it as a layer.
  653.     - On Sunday February 8th, 1987, Perry and I decided to take a trip
  654. over to Rutgers (just 10 minutes away) to take a look at how the Suns and 
  655. Macintoshes allowed you to change backdrop patterns and images.
  656.     - That same night we went to his apartment to begin writing our
  657. own backdrop enhancer for the Amiga. At    eight o'clock the next morning we
  658. had DropCloth in what essentially became release 1.0 (it was heavily
  659. cleaned up first :-)
  660.     - We had hoped that DropCloth would be part of a complete package
  661. of tools and enhancments for the Amiga,    but soon decided that it couldn't
  662. be supported well since it could degrade the preformance of the workbench
  663. (notice the delay incurred from clicking a disk icon to it's being available
  664. to be dragged). So, the project was shelved in favor of other things.
  665.     - Suddenly, we saw other people on Usenet attempting the very same
  666. thing (doesn't it always happen this way, Amiga hackers are always on the
  667. same wavelength). We posted the V1.0 binary so people could have patterns
  668. at last. The V1.0 release was also placed on Fish Disk 59
  669.     - About two weeks before the first AmiExpo in New York,    Perry and 
  670. I were talking about DropCloth again. He asked me if we really couldn't
  671. put an image into the backdrop (at one point we thought we couldn't for
  672. some silly reason). A large rock promptly hit me in the back of the head
  673. and voila! (Get the source to see how it's done).
  674.     - Perry's wrote the initial code for rendering more than just a 
  675. pattern into the backdrop for a nice little demo at AmiExpo. I took his
  676. prototype and extended it to allow all IFF images and put in WorkBench
  677. support as well.
  678.  
  679. - What it does
  680.     - Things we had to realize about the workbench:
  681.         - The Workbench renders it's icons into a 
  682.         backdrop borderless window.
  683.         - When an icon is moved SetRast() is called to
  684.         clear the layer and all the icons are redrawn.
  685.         This is fairly fast, but destroys anything you
  686.         render yourself into the backdrop.
  687.     - So, get the source to see how it's done! (plug, plug :-)
  688.  
  689. Thanks to:
  690.     Perry Kivolowitz    - Spurring me on, helping fix my bugs
  691.     Jon Trudel        - The DropCloth Icon
  692.     Andy Hertzfeld        - The original fire (
  693.  
  694.  
  695. Copyright and Shareware Notice:
  696.  
  697. DropCloth is Copyright 1987 by Eric Lavitsky. DropCloth is a shareware
  698. product. If you feel this product enhances your environment, please
  699. send a contribution to:
  700.  
  701.     Eric Lavitsky
  702.     34 Maplehurst Ln.
  703.     Piscatway, NJ 08854
  704.  
  705. Keep the shareware concept alive! Suggested donation is $10. Donations 
  706. of $15 or more will yield a disk replete with the source code to the
  707. latest version of DropCloth ($20 would be greatly appreciated). The 
  708. source code was written using Manx Aztec C, V3.5a (Yes Jim, a plug! :-),
  709. remains proprietary to Eric Lavitsky and may not be redistributed or
  710. sold without the expressed written consent of Eric Lavitsky. The 
  711. executable version of DropCloth and it's associated icons may be freely 
  712. redistributed provided this document is included in the distribution.
  713.  
  714. ****************************************************************************
  715.  
  716.